NAZWA¶

getprotoent, getprotobyname, getprotobynumber, setprotoent, endprotoent - odczytanie wpisu dotyczącego protokołu

SKŁADNIA¶

#include <netdb.h>

struct protoent *getprotoent(void);

struct protoent *getprotobyname(const char *name);

struct protoent *getprotobynumber(int proto);

void setprotoent(int stayopen);

void endprotoent(void);

OPIS¶

Funkcja getprotoent() odczytuje następną linię z pliku /etc/protocols i zwraca strukturę protoent zawierającą pola otrzymane w wyniku rozłożenia linii. Plik /etc/protocols jest otwierany, jeśli jest to potrzebne.

Funkcja getprotobyname() zwraca strukturę protoent zawierającą wartości z tej linii pliku /etc/protocols, która odpowiada protokołowi o nazwie name.

Funkcja getprotobynumber() zwraca strukturę protoent zawierającą wartości z linii odpowiadającej protokołowi o numerze number.

Funkcja setprotoent() otwiera plik /etc/protocols i ustawia wskaźnik pliku na jego początek. Jeśli stayopen będzie prawdziwe (1), to plik nie będzie zamykany pomiędzy wywołaniami getprotobyname() i getprotobynumber().

Funkcja endprotoent() zamyka /etc/protocols.

Struktura protoent jest zdefiniowana w <netdb.h> następująco:

struct protoent {
	char	*p_name;		/* oficjalna nazwa protokołu */
	char	**p_aliases;		/* lista aliasów */
	int	p_proto;		/* numer protokołu */
}

Polami struktury protoent są:

p_name

Oficjalna nazwa protokołu.

p_aliases

Zakończona zerem lista alternatywnych nazw tego protokołu.

p_proto

Numer protokołu.

WARTOŚĆ ZWRACANA¶

Funkcje getprotoent(), getprotobyname() i getprotobynumber() zwracają strukturę protoent, lub wskaźnik NULL gdy wystąpi błąd lub napotkany zostanie koniec pliku.

PLIKI¶

/etc/protocols

plik bazy danych dla protokołów

ZGODNE Z¶

BSD 4.3

ZOBACZ TAKŻE¶

getservent(3), getnetent(3), protocols(5)